Skip to main content

Installer CasaOS pour son premier HomeLab

Ce guide t'accompagne pas à pas pour installer CasaOS sur une machine Linux, puis faire la configuration initiale et déployer un premier service.

CasaOS n'est pas un système d'exploitation complet. C'est une couche d'administration qui s'installe sur Debian/Ubuntu et simplifie la gestion d'applications auto-hébergées.

info

Objectif En fin de tutoriel, tu auras:

  • un serveur Linux à jour ;
  • CasaOS installé et accessible en Web ;
  • une première application lancée ;
  • les bonnes bases de sécurité pour continuer ton HomeLab.

1. Prérequis​

Matériel minimum conseillé​

  • CPU x86_64 (2 coeurs ou plus) ;
  • 2 Go de RAM minimum (4 Go recommandés) ;
  • 16 Go de stockage minimum (SSD recommandé) ;
  • connexion Ethernet stable.

Système supporté​

CasaOS est officiellement prévu pour des distributions Linux basées sur Debian/Ubuntu.

Exemples courants:

  • Debian 12 ;
  • Ubuntu Server 22.04 / 24.04.
warning

Important Installe CasaOS sur une machine dédiée au labo ou une VM de test. Évite un poste de travail personnel qui contient déjà des données sensibles.

2. Préparer le serveur Linux​

Connecte-toi en SSH puis mets le système à jour:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl

Vérifie ensuite l'adresse IP locale:

ip a

Note l'IP du serveur (exemple: 192.168.1.50). Tu l'utiliseras pour l'accès Web à CasaOS.

tip

Conseil réseau Pour un HomeLab, configure une IP fixe (ou un bail DHCP réservé dans ton routeur) pour éviter que l'adresse du serveur change.

3. Installer CasaOS​

Lance le script d'installation officiel:

curl -fsSL https://get.casaos.io | sudo bash

L'installation prend quelques minutes. Le script télécharge les composants nécessaires, installe Docker et configure les services CasaOS.

Quand c'est terminé, vérifie l'état des services:

sudo systemctl status casaos --no-pager

Si le service est actif, l'installation est réussie.

4. Premier accès à l'interface Web​

Depuis un navigateur sur ton réseau local, ouvre:

http://IP_DU_SERVEUR

Exemple:

http://192.168.1.50

Au premier lancement, CasaOS te demande de créer un compte administrateur.

warning

Sécurité Choisis un mot de passe long et unique (au moins 14 caractères), différent de tes autres comptes.

5. Vérification rapide après installation​

Dans le terminal du serveur, contrôle les points suivants:

docker --version
sudo systemctl is-active casaos
sudo systemctl is-active docker

Résultat attendu:

  • Docker retourne une version ;
  • casaos est active ;
  • docker est active.

6. Déployer ta première application​

Depuis l'interface CasaOS:

  1. Ouvre App Store.
  2. Choisis une application simple (par exemple File Browser ou Portainer).
  3. Clique sur Install.
  4. Attends la fin du déploiement puis ouvre l'application.
info

Pourquoi commencer simple Une application légère permet de valider le réseau, les ports, le stockage et le fonctionnement Docker avant de déployer des services plus critiques.

7. Bonnes pratiques pour un premier HomeLab​

  • garde ton serveur à jour (sudo apt update && sudo apt upgrade -y) ;
  • sauvegarde les données des applications (volumes Docker) ;
  • n'expose pas directement des services sur Internet sans reverse proxy et HTTPS ;
  • active un pare-feu minimal.

Exemple avec UFW:

sudo apt install -y ufw
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status
warning

Exposition Internet Si tu publies des services, mets en place au minimum:

  • un nom de domaine ;
  • des certificats TLS valides ;
  • une authentification solide ;
  • des mises à jour régulières.

8. Dépannage rapide​

L'interface Web ne répond pas​

  • vérifie l'IP du serveur ;
  • teste un ping depuis ton poste client ;
  • contrôle les services :
sudo systemctl status casaos --no-pager
sudo systemctl status docker --no-pager

Le script d'installation échoue​

  • vérifie la connexion Internet du serveur ;
  • relance après mise à jour système ;
  • regarde les journaux :
journalctl -u casaos -n 100 --no-pager

Un conteneur ne démarre pas​

  • contrôle les logs Docker :
docker ps -a
docker logs <nom_ou_id_du_conteneur>

9. Conclusion​

Tu as maintenant une base propre pour ton premier HomeLab avec CasaOS.

Prochaine étape logique: ajouter un service utile (DNS local, sauvegarde, supervision) et documenter ton architecture au fur et à mesure.

success

Bravo Ton environnement CasaOS est prêt pour expérimenter l'auto-hébergement de manière progressive et maîtrisée.